home *** CD-ROM | disk | FTP | other *** search
/ Graphics Plus / Graphics Plus.iso / msdos / raytrace / pov / bin / povibm.exe / IBMDOCS / POVMOD.DOC < prev    next >
Text File  |  1993-10-01  |  5KB  |  124 lines
  1.   
  2.                                  POVMOD
  3.                     Virtual Memory Utility for POV-Ray 2.00
  4. ------------------------------------------------------------------------------
  5.                      
  6.  
  7. This file contains a utility program for the POV-Ray IBM-PC protected mode
  8. executable compiled with Intel's "Code Builder Kit" 32 bit "C" compiler. It
  9. is not of any use for exectuables compiled with any other compiler.
  10.  
  11. It's purpose is to expand (or reduce) the amount of virtual memory available 
  12. to POV-Ray during it's operation. 
  13.  
  14. ***************************** NOTE *******************************************
  15.                          
  16. If you get a message about running out of memory (allocation failure....,
  17. memory exhausted......, insufficient memory.... etc) you should use this
  18. utility. It's *un-needed* until your image models become complex enough to 
  19. to require more than the 3072K of virtual memory that POV-Ray uses as it's
  20. distribution default.
  21.  
  22. ******************************************************************************
  23.  
  24. The "region size" consists of the physical RAM *PLUS* the amount of disk 
  25. space allocated to a swapfile for POV-Ray. The unmodified POV-Ray will 
  26. render approx. a 15,000 triangle file. (Supports 3072K of memory. In a 
  27. machine with less than 4 megs of RAM the VMM may be used to raise it to
  28. that amount. In a machine with *more* than 3072K of RAM it will go ahead and
  29. use it, if available, when run "stand alone". I.E. when not running under a 
  30. DPMI host such as Windows, OS/2 2.x or QEMM w/ QDPMI installed.) 
  31.  
  32. To expand the amount of virtual memory available, more Hard Disk space
  33. must be allocated to POV-Ray. POVMOD will list the amount of physical RAM 
  34. available in the machine PLUS the free space on the hard disk. Any or all of 
  35. this can be allocated for POV-Ray's use during a trace. (Note: These amounts
  36. may not reflect the actual amount installed in the machine when running under
  37. a DPMI Host. They are the amounts reported by the host and must be configured
  38. in the setup of the host. For instance the amount of XMS and DPMI memory is 
  39. set under the DOS SETTINGS for an OS/2 2.x DOS session.)
  40.  
  41. Use of POVMOD.  
  42. --------------
  43. Place POVMOD in the same directory as POVRAY.EXE. From the command
  44. line type:
  45.  
  46. POVMOD POVRAY.EXE  <enter>
  47.  
  48. The program will run and present a list of the current parameters that 
  49. POV-Ray operates under. The number in the upper right corner of the table
  50. (The one labeled "Region Size:") is the amount of memory (Both virtual 
  51. and physical combined AT THAT TIME.) that POV-Ray can use. I.E. The current
  52. setting. 
  53.  
  54. Press (M)odify to change the parameters. 
  55.  
  56. Press (E)nter to alter the region size. You can then manually enter 
  57. the amount of memory you would like to have available for the program 
  58. to use. Generally a value of 6M to 10M will cover all but the most 
  59. complex images.
  60.  
  61. The (A)ccept key will configure the region size for the largest possible 
  62. swap file size.
  63. (NOTE: (A)ccept is not the best choice in most cases. If there is
  64.        a large amount of free space on your HD it could result in a
  65.        *very* large swap file.)
  66.  
  67.  
  68. The (C)reate option will create a -permanent- swap file.
  69.  
  70. *** Remember you need enough free disk space to write out your image ***
  71. *** file as it is created though!!!                                  ***
  72.  
  73. The POV-Ray executable file will then be modified to reflect your choices. 
  74. Since much of this "memory" is usually a swap file on your hard disk you 
  75. will get *much* better performance with a recently de-fragmented disk. 
  76. The program will NOT allow you to allocate a larger region size than can 
  77. be created AT THAT TIME. I.E. if you have 6 Megs of combined RAM/Hard Disk 
  78. space avail. you cannot make the region size any larger than that. Also if 
  79. the region size is set to a particular amount and your hard disk is later 
  80. filled to the point that the free disk space is not large enough for the 
  81. required swap file to be created, the program will *NOT* run. It will error 
  82. with an insufficient memory message. You will need to modify the region 
  83. size to accommodate the smaller amount of disk space available. 
  84.  
  85. An environment variable is used to "point" to the location of the swap
  86. file. The DEFAULT swap file is C:\XMSWAP.TMP. To set it to another 
  87. location the following must be added to your AUTOEXEC.BAT file:
  88.  
  89. SET SWAP=d:\[subdir]\XMSWAP.TMP 
  90.  
  91. Where d: is the drive and [subdir] is the subdirectory you wish to use
  92. for the swapfile. You will need to reboot the machine for this parameter
  93. to take effect.
  94.  
  95. (Note: The test triangle files referred to were generated with FRGEN 1.1.)
  96.  
  97.  
  98.  
  99. --------------------------------
  100.         OS/2 2.x Note
  101. --------------------------------
  102.  
  103. When running POV-Ray under OS/2 2.x you need to set the DPMI_MEMORY_LIMIT
  104. value under the DOS SETTINGS for the session to a value GREATER than or
  105. EQUAL to the Region Size you set in the POVRAY executable with this program. 
  106.  
  107. See IBMPCEXE.DOC for further information.
  108.  
  109.  
  110.  
  111.  
  112. Bill Pulver
  113.  
  114. CIS     : 70405,1152                 <---- Most often used.
  115. InterNET: 70405.1152@compuserve.com
  116. AOL     : BPulver
  117.  
  118. Less often used:
  119. Delphi :  BILLP
  120. Prodigy:  NCCJ93A
  121. Genie  :  B.Pulver
  122.               
  123. 9/26/93
  124.